<?php
/*
 * Copyright (c) 2008 Sergey Bondari, bondari@bondari.net
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * - Redistributions of source code must retain the above copyright
 *   notice, this list of conditions and the following disclaimer.
 * - Redistributions in binary form must reproduce the above copyright
 *   notice, this list of conditions and the following disclaimer in the
 *   documentation and/or other materials provided with the distribution.
 * - The name of the author may not be used to endorse or promote products
 *   derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

namespace Mosaic\System;

/**
 * Remote object skeleton abstract
 * 
 * All remote objects should derived from this simple class. It reserves some of the method names
 * and defines am explicite constructor as the __construct is reserved due to the implementaiton limits.
 * 
 *
 * @package System
 * @subpackage Node
 */
class RemoteObjectSkeleton {

	/**
	 * Object constructor
	 * Override this method to use instead of __construct
	 * @final
	 */
	protected function Constructor() {
		// constructor
	}

	/**
	 * Method name reservation.
	 * @see Constructor
	 * @final
	 */
	final function __construct($args = NULL) {
		if (is_array($args)) {
			call_user_func_array(array($this, 'Constructor'), $args);
		} else {
			call_user_func(array($this, 'Constructor'));
		}
	}


	/**
	 * Method name reservation
	 * @final
	 */
	final public function __getUri() {
		return '';
	}

	/**
	 * Method name reservation
	 * @final
	 */
	final public function __bind() {
		// never reached. method name used only by broker.
	}

	/**
	 * Method name reservation
	 * @final
	 */
	final public function __unbind() {
		// never reached. method name used only by broker.
	}


}

